import 'package:flutter/material.dart';  // 导入Material UI组件库

/*
路由(Route)在移动开发中通常指页面(Page),与web开发中单页面营业的Route的概念是相同的.
路由管理,就是管理页面之间如何跳转,路由管理会维护一个路由栈,路由入栈(push)操作对应打开
一个新页面,路由出栈(pop)操作对应页面关闭.路由管理就是管理路由栈
 */
class FirstApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    // Material库提供的Flutter App框架, 可通过它设置应用的名称,主题,语言,首页以及路由列表等
    return MaterialApp(
      // app 标题
        title: 'Flutter Demo',
        theme: ThemeData(
          // 蓝色主题
          primarySwatch: Colors.blue,
          visualDensity: VisualDensity.adaptivePlatformDensity,
        ),
        showPerformanceOverlay: true,
        // app首页
        home: MyHomePage(title: 'Flutter Demo Home Page'),
        onGenerateRoute: (RouteSettings settings){
          // 命名路由,给路由一个名字,然后可以通过路由名字直接打开新的路由,而不用通过路
          // 由的栈的FIFO或其他繁琐的方式来实现
          // 通过路由名打开新路由
          if(settings.name=='tip'){
            return MaterialPageRoute(builder: (context){
              return TipRoute(text: settings.arguments);
            });
          }else if(settings.name=='new_page'){
            return MaterialPageRoute(builder: (context)=>NewRoute());
          }
          return null;
        },
        // 路由表(Map<String, WidgetBuilder>),要想使用命名路由,必须提供并注册一个路由
        // 表,这样app才知道name和route如何对应
        // 命名路由缺点,传给路由的参数只能在路由表注册之前传入,注册之后无法修改内容
        routes: {
          'new_page': (context)=>NewRoute(),
          'tip': (context){
            return TipRoute(text: ModalRoute.of(context).settings.arguments);
          }, // 注册首页路由
        }
    );
  }
}

class NewRoute extends StatelessWidget {
  @override
  Widget build(BuildContext context){
    // material库中提供的页面脚手架,它包含导航栏,body以及悬浮按钮(如果需要)
    return Scaffold(
        appBar: AppBar(
            title: Text("New route")
        ),
        body: Center(
            child: Text("This is new route")
        )
    );
  }
}

class TipRoute extends StatelessWidget {
  TipRoute({Key key,
    @required this.text, // 接收一个text参数
  }):super(key: key);
  final String text;

  @override
  Widget build(BuildContext context){
    return Scaffold(
      appBar: AppBar(
        title: Text("提示"),
      ),
      body: Padding(
          padding: EdgeInsets.all(18),
          child: Center(
              child: Column(
                children: <Widget>[
                  Text(text),
                  RaisedButton(
                    onPressed: ()=>Navigator.pop(context, "我是返回值"),
                    child: Text("返回"),
                  )
                ],
              )
          )
      ),
    );
  }
}

class RouterTestRoute extends StatelessWidget{
  @override
  Widget build(BuildContext context){
    return Center(
        child: RaisedButton(
            onPressed: () async {
              var result = await Navigator.push(
                context,
                MaterialPageRoute(
                    builder: (context)=>TipRoute(text: '我是提示xxx')
                ),
              );
              print("路由返回值: $result");
            },
            child: Text('打开提示页')
        )
    );
  }
}

// app首页, 有状态的Widget, 至少由两个类组成, 一个StatefulWidget, 一个State类
// StatefulWidget本身是不变的, 但State类中持有的状态在widget生命周期中可能会发生变化
class MyHomePage extends StatefulWidget {
  MyHomePage({Key key, this.title}) : super(key: key);
  final String title;

  @override
  _MyHomePageState createState() => _MyHomePageState();

/*
  有状态的widget将build方法移至State类的好处, 主要是为了开发的灵活性
  如果build方法依然在StatefulWidget类中,会有两个问题:
  1. 状态访问不方便
  如果StatefulWidget有很多状态,而每次状态改变都要调用build方法, 由于状态是保存在State中的,
  如果将build方法放在StatefulWidget方法中, 那么构建时读取状态将会很不方便, 因为构建过程需要
  依赖State, 所以build方法将必须加一个State参数, 比如:
  Widget build(BuildContext context, State state){}
  这样的话就只能将State的所有状态声明为公开的状态,这样才能在State类外部访问状态,但将状态设置
  为公开后,状态将不再具有私密性,这样依赖,对状态的修改将会变得不可控.
  2. 继承StatefulWidget不方便
  现在有个动画widget的基类AnimatedWidget, 继承自StatefulWidget类. AnimatedWidget引入了一个
  抽象方法build(BuildContext context), 继承自AnlimatedWidget的动画widget都要实现这个build
  方法. 现在如果StatefulWidget中已经有了一个build方法,正如1所说,需要接受一个State对象,这就
  意味着AnimatedWidget必须将自己的State对象提供给其子类,因为子类需要在其build方法中调用父类
  的build方法, 比如:
  class MyAnimatedWidget extends AnimatedWidget{
    Widget build(BuildContext context, State state){
    // 由于子类要用到父类AnimatedWidget的状态对象,所以父类必须通过某种方式将其状态对象
    // 暴露给其子类
      super.build(context, state);
    }
  }
  这样显然并不合理,因为:
  1. AnimatedWidget的状态对象是其内部实现细节,不应该暴露给外部
  2. 如果要将父类状态暴露给子类,那么必须有一种传递机制,而做这一套传递机制其实是无意义的,因为
  父子类之间状态的传递和子类本身的逻辑是无关的
  综上所述, 对于有状态的StatefulWidget, 将build方法放在State中,可以给开发带来很大的灵活性.
   */
}

class _MyHomePageState extends State<MyHomePage> {
  int _counter = 0;

  void _incrementCounter() {
    // 通知Flutter框架,有状态发生了改变,
    // Flutter框架收到通知后,会执行build方法来根据新的状态重新构建界面
    // Flutter会对此方法做优化,使重新构建界面很快,所以我们可以重新构建任何需要更新的东西,而
    // 无需分别去修改各个widget
    setState(() {
      // 这里的语句会先于setState执行
      _counter++;
    });
  }

  // 构建UI的逻辑 当MyHomePage第一次创建时, _MyHomePageState类会被创建,
  // 当初始化完成后, Flutter框架会调用Widget的build方法来构建widget树,
  // 最终将widget树渲染到设备屏幕上
  @override
  Widget build(BuildContext context) {
    // Material库提供的一个脚手架,提供了默认的导航栏,标题和包含主屏幕widget树的body属性. widget树可以很复杂
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      // body的widget树中包含了一个Center, Center可以将其子widget树对齐到屏幕中心,
      // Center子widget是一个Column widget
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            Text(
              'You have pushed the button this many times:',
            ),
            Text(
              '$_counter',
              style: Theme.of(context).textTheme.headline4,
            ),
            FlatButton(
              child: Text('open new route'),
              // 按钮文字颜色 蓝色
              textColor: Colors.blue,
              onPressed: (){
                //导航到新路由
//                Navigator.push(context,
                /*
              继承自PageRoute类,是一个抽象类,表示占有整个屏幕空间的一个模态路由页面,
              还定义了路由构建及切换时过度动画的相关接口及属性. 针对不同平台实现与平台
              页面切换动画风格一致的路由切换动画:
              android: 打开新页面从屏幕底部滑动到屏幕顶部;关闭时,从顶部滑动到底部然后
              消失,同时上一个页面会显示在屏幕上
              ios: 打开新页面从屏幕右侧边缘一致滑动到屏幕左边,直到新页面全部显示在屏幕
              上, 而上一个页面则会从当前屏幕滑动到屏幕左侧而消失; 关闭时,正好相反, 当
              前页面从屏幕右侧滑出,同时上一个页面会从屏幕左侧滑入
              MaterialPageRoute构造函数参数的意义:
              MaterialPageRoute({
                // 回调函数,构建路由页面的具体内容,返回一个widget. 通常实现此回调,
                // 返回新路由的实例
                WidgetBuilder builder,
                // 包含路由的配置信息,如名称,是否初始路由(首页)
                RouteSettings settings,
                // 默认情况下,当入栈一个路由时,原来的路由仍然会被保存在内存中,如果想
                // 在路由没用的时候释放其所占用的所有资源,可以设置为false
                bool maintainState = true,
                // 表示新的路由页面是否是一个全屏的模态对话框,在ios中,如果为true,新
                // 页面将会从屏幕底部滑入(而不是水平方向)
                bool fullscreenDialog = false,
                如果想自定义路由切换动画,可以自己继承PageRoute来实现
              })
             */
//                    MaterialPageRoute(builder: (context)=>NewRoute()));
                /*
              Navigator是一个路由管理的widget,通过一个栈来管理一个路由widget集合.通
              常当前屏幕显示的页面就是栈顶的路由.
              Future push(BuildContext context, Route route)
              将给定的路由入栈,返回一个Future,用以接收新路由出栈(及关闭)时的返回数据
              bool pop(BuildContext context, [ result ])
              将栈顶路由出栈, result为页面关闭时返回给上一个页面的数据
               */
                Navigator.push(context,
                    MaterialPageRoute(builder: (context)=>RouterTestRoute()));
                // 按路由名打开新路由
                // Navigator.pushNamed(context, "new_page");
              },
            ),
          ],
        ),
      ),
      // 页面右下角的悬浮按钮
      floatingActionButton: FloatingActionButton(
        // 接受一个回调函数作为按下后的处理器
        onPressed: _incrementCounter,
        tooltip: 'Increment',
        child: Icon(Icons.add),
      ), // This trailing comma makes auto-formatting nicer for build methods.
    );
  }
}
